<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>服务器和执行环境信息</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="reserved.variables.globals.html">$GLOBALS</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="reserved.variables.get.html">$_GET</a></div>
 <div class="up"><a href="reserved.variables.html">预定义变量</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="reserved.variables.server" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">$_SERVER</h1>
  <h1 class="refname">$HTTP_SERVER_VARS [已弃用]</h1>
  <p class="refpurpose"><span class="refname">$_SERVER</span> -- <span class="refname">$HTTP_SERVER_VARS [已弃用]</span> &mdash; <span class="dc-title">服务器和执行环境信息</span></p>

 </div>
 
 <div class="refsect1 description" id="refsect1-reserved.variables.server-description">
  <h3 class="title">说明</h3>
  <p class="para">
   <var class="varname"><var class="varname">$_SERVER</var></var> 是一个包含了诸如头信息(header)、路径(path)、以及脚本位置(script locations)等等信息的数组。这个数组中的项目由 Web 服务器创建。不能保证每个服务器都提供全部项目；服务器可能会忽略一些，或者提供一些没有在这里列举出来的项目。这也就意味着大量的此类变量都会在<a href="http://www.faqs.org/rfcs/rfc3875" class="link external">&raquo;&nbsp;CGI 1.1 规范</a>中说明，所以应该仔细研究一下。
  </p>

  <p class="simpara">
   <var class="varname"><var class="varname">$HTTP_SERVER_VARS</var></var> 包含着相同的信息，但它不是一个<a href="language.variables.superglobals.html" class="link">超全局变量</a>。
   (注意 <var class="varname"><var class="varname">$HTTP_SERVER_VARS</var></var> 与 <var class="varname"><var class="varname">$_SERVER</var></var> 是不同的变量，PHP处理它们的方式不同)
  </p>
 </div>


 <div class="refsect1 indices" id="refsect1-reserved.variables.server-indices">
  <h3 class="title">目录</h3>

  <p class="simpara">
   在 <var class="varname"><var class="varname">$_SERVER</var></var> 中，你也许能够，也许不能够找到下面的这些元素。注意，如果以<a href="features.commandline.html" class="link">命令行</a>方式运行 PHP，下面列出的元素几乎没有有效的(或是没有任何实际意义的)。 
  </p>

  <p class="para">
   <dl>

    
     <dt>
&#039;<var class="varname"><var class="varname">PHP_SELF</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当前执行脚本的文件名，与 document root 有关。例如，在地址为 <var class="filename">http://example.com/test.php/foo.bar</var> 的脚本中使用 <var class="varname"><var class="varname">$_SERVER['PHP_SELF']</var></var> 将得到 <var class="filename">/test.php/foo.bar</var>。<a href="language.constants.predefined.html" class="link">__FILE__</a> 常量包含当前(例如包含)文件的完整路径和文件名。
      </span>
      <span class="simpara">
       从 PHP 4.3.0 版本开始，如果 PHP 以命令行模式运行，这个变量将包含脚本名。之前的版本该变量不可用。
      </span>
     </dd>

    

    
     <dt>
&#039;<a href="reserved.variables.argv.html" class="link">argv</a>&#039;</dt>

     <dd>

      <span class="simpara">
        传递给该脚本的参数的数组。当脚本以命令行方式运行时，argv 变量传递给程序 C 语言样式的命令行参数。当通过 GET 方式调用时，该变量包含query string。
      </span>
     </dd>

    

    
     <dt>
&#039;<a href="reserved.variables.argc.html" class="link">argc</a>&#039;</dt>

     <dd>

      <span class="simpara">
       包含命令行模式下传递给该脚本的参数的数目(如果运行在命令行模式下)。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">GATEWAY_INTERFACE</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       服务器使用的 CGI 规范的版本；例如，“<em>CGI/1.1</em>”。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">SERVER_ADDR</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当前运行脚本所在的服务器的 IP 地址。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">SERVER_NAME</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当前运行脚本所在的服务器的主机名。如果脚本运行于虚拟主机中，该名称是由那个虚拟主机所设置的值决定。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">SERVER_SOFTWARE</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       服务器标识字符串，在响应请求时的头信息中给出。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">SERVER_PROTOCOL</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       请求页面时通信协议的名称和版本。例如，“HTTP/1.0”。
      </span>
     </dd>

    
    
    
     <dt>
&#039;<var class="varname"><var class="varname">REQUEST_METHOD</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       访问页面使用的请求方法；例如，“<em>GET</em>”, “<em>HEAD</em>”，“<em>POST</em>”，“<em>PUT</em>”。
      </span>
      <blockquote class="note"><p><strong class="note">Note</strong>: 
       <p class="para">
        如果请求方法为 <em>HEAD</em>，PHP 脚本将在发送 Header 头信息之后终止(这意味着在产生任何输出后，不再有输出缓冲)。
       </p>
      </p></blockquote>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">REQUEST_TIME</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       请求开始时的时间戳。从 PHP 5.1.0 起可用。
      </span>
     </dd>

    
    
    
     <dt>
&#039;<var class="varname"><var class="varname">REQUEST_TIME_FLOAT</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       请求开始时的时间戳，微秒级别的精准度。
       自 PHP 5.4.0 开始生效。
      </span>
     </dd>

    
     
    
     <dt>
&#039;<var class="varname"><var class="varname">QUERY_STRING</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       query string（查询字符串），如果有的话，通过它进行页面访问。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">DOCUMENT_ROOT</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当前运行脚本所在的文档根目录。在服务器配置文件中定义。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">HTTP_ACCEPT</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当前请求头中 <em>Accept:</em> 项的内容，如果存在的话。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">HTTP_ACCEPT_CHARSET</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当前请求头中 <em>Accept-Charset:</em> 项的内容，如果存在的话。例如：“<em>iso-8859-1,*,utf-8</em>”。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">HTTP_ACCEPT_ENCODING</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当前请求头中 <em>Accept-Encoding:</em> 项的内容，如果存在的话。例如：“<em>gzip</em>”。
      </span>
     </dd>

    
    
    
     <dt>
&#039;<var class="varname"><var class="varname">HTTP_ACCEPT_LANGUAGE</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当前请求头中 <em>Accept-Language:</em> 项的内容，如果存在的话。例如：“<em>en</em>”。
      </span>
     </dd>

    
    
    
     <dt>
&#039;<var class="varname"><var class="varname">HTTP_CONNECTION</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当前请求头中 <em>Connection:</em> 项的内容，如果存在的话。例如：“<em>Keep-Alive</em>”。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">HTTP_HOST</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当前请求头中 <em>Host:</em> 项的内容，如果存在的话。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">HTTP_REFERER</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       引导用户代理到当前页的前一页的地址（如果存在）。由 user agent 设置决定。并不是所有的用户代理都会设置该项，有的还提供了修改 <var class="varname"><var class="varname">HTTP_REFERER</var></var> 的功能。简言之，该值并不可信。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">HTTP_USER_AGENT</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当前请求头中 <em>User-Agent:</em> 项的内容，如果存在的话。该字符串表明了访问该页面的用户代理的信息。一个典型的例子是：<span class="computeroutput">Mozilla/4.5 [en] (X11; U;
       Linux 2.2.9 i586)</span>。除此之外，你可以通过 <span class="function"><a href="function.get-browser.html" class="function">get_browser()</a></span> 来使用该值，从而定制页面输出以便适应用户代理的性能。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">HTTPS</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
      如果脚本是通过 HTTPS 协议被访问，则被设为一个非空的值。 
      </span>
      <blockquote class="note"><p><strong class="note">Note</strong>: 
       <span class="simpara">
        注意当使用 IIS 上的 ISAPI 方式时，如果不是通过 HTTPS 协议被访问，这个值将为 <em>off</em>。
       </span>
      </p></blockquote>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">REMOTE_ADDR</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       浏览当前页面的用户的 IP 地址。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">REMOTE_HOST</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       浏览当前页面的用户的主机名。DNS 反向解析不依赖于用户的 <var class="varname"><var class="varname">REMOTE_ADDR</var></var>。
      </span>
      <blockquote class="note"><p><strong class="note">Note</strong>: 
       <span class="simpara">
        你的服务器必须被配置以便产生这个变量。例如在 Apache 中，你需要在 <var class="filename">httpd.conf</var> 中设置 <em>HostnameLookups On</em> 来产生它。参见 <span class="function"><a href="function.gethostbyaddr.html" class="function">gethostbyaddr()</a></span>。
       </span>
      </p></blockquote>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">REMOTE_PORT</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       用户机器上连接到 Web 服务器所使用的端口号。
      </span>
     </dd>

    
    
     <dt>
&#039;<var class="varname"><var class="varname">REMOTE_USER</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
        经验证的用户
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">REDIRECT_REMOTE_USER</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
        验证的用户，如果请求已在内部重定向。
      </span>
     </dd>

    
    
     <dt>
&#039;<var class="varname"><var class="varname">SCRIPT_FILENAME</var></var>&#039;</dt>

     <dd>

      <p class="para">
       当前执行脚本的绝对路径。
       <blockquote class="note"><p><strong class="note">Note</strong>: 
        <p class="para">
         如果在命令行界面（Command Line Interface, CLI）使用相对路径执行脚本，例如 <var class="filename">file.php</var> 或 <var class="filename">../file.php</var>，那么 <var class="varname"><var class="varname">$_SERVER['SCRIPT_FILENAME']</var></var> 将包含用户指定的相对路径。
        </p>
       </p></blockquote>
      </p>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">SERVER_ADMIN</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       该值指明了 Apache 服务器配置文件中的 SERVER_ADMIN 参数。如果脚本运行在一个虚拟主机上，则该值是那个虚拟主机的值。 
      </span>
     </dd>

    
    
    
     <dt>
&#039;<var class="varname"><var class="varname">SERVER_PORT</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
        Web 服务器使用的端口。默认值为 “<em>80</em>”。如果使用 SSL 安全连接，则这个值为用户设置的 HTTP 端口。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">SERVER_SIGNATURE</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       包含了服务器版本和虚拟主机名的字符串。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">PATH_TRANSLATED</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当前脚本所在文件系统（非文档根目录）的基本路径。这是在服务器进行虚拟到真实路径的映像后的结果。
      </span>
      <blockquote class="note"><p><strong class="note">Note</strong>: 
       <span class="simpara">
       自 PHP 4.3.2 起，<span class="envar">PATH_TRANSLATED</span> 在 Apache 2 <acronym title="Server Application Programming Interface">SAPI</acronym> 模式下不再和 Apache 1 一样隐含赋值，而是若 Apache 不生成此值，PHP 便自己生成并将其值放入 <span class="envar">SCRIPT_FILENAME</span> 服务器常量中。这个修改遵守了 <acronym title="Common Gateway Interface">CGI</acronym> 规范，<span class="envar">PATH_TRANSLATED</span> 仅在 <span class="envar">PATH_INFO</span> 被定义的条件下才存在。
       </span>
       <span class="simpara">
        Apache 2 用户可以在 <var class="filename">httpd.conf</var> 中设置 <em>AcceptPathInfo = On</em> 来定义 <span class="envar">PATH_INFO</span>。
       </span>
      </p></blockquote>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">SCRIPT_NAME</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       包含当前脚本的路径。这在页面需要指向自己时非常有用。<a href="language.constants.predefined.html" class="link">__FILE__</a> 常量包含当前脚本(例如包含文件)的完整路径和文件名。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">REQUEST_URI</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       URI 用来指定要访问的页面。例如 “<em>/index.html</em>”。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">PHP_AUTH_DIGEST</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当作为 Apache 模块运行时，进行 HTTP Digest 认证的过程中，此变量被设置成客户端发送的“Authorization” HTTP 头内容（以便作进一步的认证操作）。 
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">PHP_AUTH_USER</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当 PHP 运行在 Apache 或 IIS（PHP 5 是 ISAPI）模块方式下，并且正在使用 HTTP 认证功能，这个变量便是用户输入的用户名。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">PHP_AUTH_PW</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当 PHP 运行在 Apache 或 IIS（PHP 5 是 ISAPI）模块方式下，并且正在使用 HTTP 认证功能，这个变量便是用户输入的密码。 
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">AUTH_TYPE</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       当 PHP 运行在 Apache 模块方式下，并且正在使用 HTTP 认证功能，这个变量便是认证的类型。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">PATH_INFO</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       包含由客户端提供的、跟在真实脚本名称之后并且在查询语句（query string）之前的路径信息，如果存在的话。例如，如果当前脚本是通过 URL <var class="filename">http://www.example.com/php/path_info.php/some/stuff?foo=bar</var> 被访问，那么 <var class="varname"><var class="varname">$_SERVER['PATH_INFO']</var></var> 将包含 <em>/some/stuff</em>。
      </span>
     </dd>

    

    
     <dt>
&#039;<var class="varname"><var class="varname">ORIG_PATH_INFO</var></var>&#039;</dt>

     <dd>

      <span class="simpara">
       在被 PHP 处理之前，“<var class="varname"><var class="varname">PATH_INFO</var></var>” 的原始版本。
      </span>
     </dd>

    

   </dl>

  </p>
 </div>

 
 <div class="refsect1 changelog" id="refsect1-reserved.variables.server-changelog">
  <h3 class="title">更新日志</h3>
  <p class="para">
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>版本</th>
       <th>说明</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>4.1.0</td>
       <td>
        引入 <var class="varname"><var class="varname">$_SERVER</var></var>，弃用 <var class="varname"><var class="varname">$HTTP_SERVER_VARS</var></var>。
       </td>
      </tr>

     </tbody>
    
   </table>

  </p>
 </div>

 
 <div class="refsect1 examples" id="refsect1-reserved.variables.server-examples">
  <h3 class="title">范例</h3>
  <p class="para">
   <div class="example" id="variable.server.basic">
    <p><strong>Example #1 <var class="varname"><var class="varname">$_SERVER</var></var> 范例</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">echo&nbsp;</span><span style="color: #0000BB">$_SERVER</span><span style="color: #007700">[</span><span style="color: #DD0000">'SERVER_NAME'</span><span style="color: #007700">];<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <div class="example-contents"><p>以上例程的输出类似于：</p></div>
    <div class="example-contents screen">
<div class="cdata"><pre>
www.example.com
</pre></div>
    </div>
   </div>
  </p>
 </div>

 
 <div class="refsect1 notes" id="refsect1-reserved.variables.server-notes">
  <h3 class="title">注释</h3>
  <blockquote class="note"><p><strong class="note">Note</strong>: <p class="para">“Superglobal”也称为自动化的全局变量。这就表示其在脚本的所有作用域中都是可用的。不需要在函数或方法中用
<strong class="command">global $variable;</strong> 来访问它。</p></p></blockquote>
 </div>


 <div class="refsect1 seealso" id="refsect1-reserved.variables.server-seealso">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li class="member"><a href="book.filter.html" class="link">过滤器扩展</a></li>
   </ul>
  </p>
 </div>


</div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="reserved.variables.globals.html">$GLOBALS</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="reserved.variables.get.html">$_GET</a></div>
 <div class="up"><a href="reserved.variables.html">预定义变量</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
